perm filename WHO.BH[UP,DOC] blob sn#130871 filedate 1974-11-18 generic text, type T, neo UTF8
The WHO command (abbreviated W) runs the WHO program,  which displays
system status information at your terminal.  If you are at  a display
terminal, the  information is  automatically updated  as long  as the
program continues to run.  If you are at a Teletype,  the information
is only  typed once.  The  WHO command does  not require that  you be
logged in.

The  first part  of the  WHO display  is a  list of  the jobs  on the
system,  with  various  information about  each  job.   This  list is
divided into two sections, for jobs belonging to users and for system
phantom  jobs.  (More  precisely,  the second  section  contains jobs
which are detached and have the JLOG bit off in the job  status word,
i.e.,  are not  logged in.)   Jobs attached  to  pseudo-teletypes are
listed under the  controlling job, with  the line for  the controlled
job indented.  The listing for each job has several parts:

  JOB      job number
  QUEUE    queue name, as in the WHO line, with possibly an extra
           character meaning one of several states (if more than one
           applies, the one listed first below is displayed):
           -  the job is now actually running
           ⊗  the job is locked in core
           →  the job is an upper segment, next to be swapped in
           ↑  the job is next in line to be swapped out
           ↓  the job is next in line to be swapped in
           *  the job is swapped out
           ↔  the job is next in line to be moved in core
  PPN      the job's logged-in PPN
           (This will be 100100 for not-logged-in WHOs, etc.)
  LINE     the job's terminal line number, or DET for detached jobs
  JOBNAM   the job name
  SIZE     the job's core image size in K (1024-word blocks)
  TIME     the job's total run time since login
  PL       percentage of CPU time spent on this job recently
  SL       service level reservation for this programmer
  SEG      job number of this job's upper segment
  SW10     number of ticks between startups of job's PDP-10
           spacewar module
  SW6      number of ticks between startups of job's PDP-6
           spacewar module

After the  job display  comes a similar  display for  upper segments,
containing the job  number, job name, core  size, and number  of jobs
using the segment.

The  next part  of the  WHO display  is a  summary of  overall system
statistics.   This  includes  the  time  since  the  system  was last
restarted (UPTIME); short and  long term time spent running  the null
job (NULTIMES); short and long  term time spent running the  null job
when another job wanted to be run but wasn't in core  (WASTED); total
user core  image sizes in  core and swapped  out (CORE);  the largest
contiguous free block of core, the total available user core not used
by locked-in jobs,  and the total  available user core  (USABLE); the
number of  jobs in  RUNQ and TQ  and their  combined core  image size
(RUNNING JOBS); and the total service level reservation for logged-in
users (TOTAL SLEVEL).

The final section of the WHO display is a list of all I/O  devices in
use by programs or assigned by  jobs.  For each such use of  a device
(at  most  one  per  device except  for  DSK),  a  line  is displayed
containing the logical name, if any; the physical name; the character
"#" if the device was assigned by the ASSIGN command; the  job number
using  the device;  if  a particular  file  is open,  the  file name,
extension, and directory ppn (for disk files), the number  of records
in the  file, the  record currently  being read  or written,  and the
read/write  status.  This  last will  be W  if the  file is  open for
output, R for input, or RA for read/alter mode, followed by E  if the
end of file has been read.  Note: if the file has been  closed, there
may  be  no  mode  flag,  and  a  large  number  like  1101   in  the
current-record position.  Record numbers are displayed in octal.

On display  terminals, only  a part of  this display  can fit  on the
screen at any  time.  Single-character commands  can be typed  to WHO
which provide "scrolling" of the display as well as  other functions.
The following commands are understood:

  ↓        scroll down 1/2 screen size
  ↑        scroll up 1/2 screen size
  ∞        run forever (otherwise WHO exits after nothing has been
           typed in for two minutes)
  R        only display jobs which have recently been Running
           (not in NULQ, STOP, IOWQ, or INTW)
  M        only display My jobs (login or alias programmer name must
           agree with user's login or alias programmer name)
  V	   only display jobs belonging to Volleyball players (to be
	   added to or removed from the list see the User Services
	   Department)
  N        restore Normal display (all jobs)
  E        Exit, leaving information displayed on the screen and with
           the page printer set up to avoid erasing it
  1-9      repeat argument for ↓ or ↑

Any other character will make WHO restore the page printer  to normal
and exit.